COMMENT ⊗   VALID 00002 PAGES
C REC  PAGE   DESCRIPTION
C00001 00001
C00002 00002	The RCV program					August 1, 1973
C00015 ENDMK
C⊗;
The RCV program					August 1, 1973

This program is provided to allow MAIL messages to be selectively
deleted, listed, or saved as desired.  The program is called by
simply entering the monitor command RCV.  All mail files which can
be construed as being for you are offered for your perusal; if you
are logged in as [PRJ,PRG], mail files for PRG or [PRJ,PRG] are
automatically listed; mail files for [PRJ,*] or [otherproj,PRG] are
announced if they exist and you are asked whether or not you wish to
edit them.  It is also possible to edit other users' mail files with
RCV by giving an argument, e.g., "RCV BH"; this argument can be
PRG or PRJ,PRG or PRJ, or any of those inside brackets.  In this
case, mail for PRG, [PRJ,PRG], or [PRJ,*] respectively will be
listed automatically, and you will be asked about [anyproj,PRG],
[otherproj,PRG] (or just PRG), or [PRJ,anyprog] respectively.
If there is a message file exactly matching the argument (or your
prg if no argument), it will be edited before any other files.
RCV * will edit NOTICE.TXT[2,2].

RCV also allows editing of the files created by the A.P. news service
automatic notification feature; you are asked whether or not you
want to edit such a file addressed to the user whose mail you are
examining if it exists.  The command "RCV \" (or "RCV \arg") will
examine the A.P. notices first.

It is also possible to use RCV on files not in [2,2] (such as saved
message files previously created with RCV) with a command like:
	RCV #filespec
with default of DSK:SAVED.MSG in your (alias) disk area.  The conventions
given below for output file specs also apply here.

*** NOTE: ONCE RCV HAS OPENED A MESSAGE FILE, YOU SHOULD EXIT ONLY ***
*** BY TYPING "E" TO AN OPTION REQUEST, AS EXPLAINED BELOW. TYPING ***
*** <CALL> TO EXIT MAY RESULT IN LOSING SOME OF YOUR MESSAGE TEXT! ***

When a mail file is opened, messages are typed out one at a time
and you are asked for a processing option.  The available options are
    S	which Saves the message in the mail file
    D	which Deletes the message
    C	which Copies it to another file, keeping it in the mail file too
    T	which Transfers it from the mail file to another file
    L	which spools it for the Lpt and deletes it from the mail file
    X	which spools it for the Xgp and deletes it from the mail fi le
    Z	which allows line-at-a-time editing from display terminals
    E	which saves it like S and Exits, saving all remaining messages
    F	which sets the File name for C and T (see below)
    ?	which lists these options

If you use an argument in the RCV command to edit another user's mail,
the first time you specify any option which would remove a message
from the mail file or alter its contents you are asked to confirm it.
Once you have confirmed such an option, however, you are not asked again.

The Z option, for line-by-line editing, is allowed only from display
terminals (III or DataDisc) and only if the message is not so long as
to overflow RCV's buffer.  The message lines are loaded into your
console line editor one at a time, not including the header line or
the space at the beginning of each text line.  You can edit the line
with the usual line editor commands, and type <cr> when done.  If you
want to cancel the changes to a line while it is still in the line
editor, you can type <altmode>, which will load the original line into
the line editor again.  If you want to stop editing, leaving the
remaining lines as they were, type <control><cr> instead of <cr> after
the last line's edits (like E's line insert mode).  Lines which are
blank (like between messages) are not edited.  To delete a line, type
<control><meta>D when it is loaded in the line editor.  To insert
new lines before the line in the line editor, type <control><meta>I
or <control><meta><cr>; then type the new lines, ending each with
<cr> except the last, which should be ended with <control><cr>.
(Also like E line insert.)  If you have major changes to a message
you will be better off using the T option to move it to a separate
file, editing with TV, and re-mailing it.

The first time you specify C or T, you are asked to specify a file name.
You can reply with a standard file spec, "?", or <cr>.  <cr> uses the
default file name, initially DSK:SAVED.MSG in your area.  "?" will
print a helpful message and let you try again.  Thereafter, whatever file
you specified will be used for all C and T messages (the file is not
closed until you exit or select another one) until you specify option F,
which asks for a new file name and then for the processing option again.
The file which was open for C and T messages provides default extension,
etc. for the new request, e.g., if the first time around you selected
MAIL.FOO[S,SYS], if you then type F and specify filename MOBY you will
get MOBY.FOO[S,SYS] rather than MOBY.MSG in your area.  Note:  if the
specified file already exists, the new messages are appended to it.

The notation ↓chars↓ may be used to get non-alphameric characters in a
filename.  In addition, a shorthand notation is provided for entering
names of mail files: if the character ∂ is the first character of the
file spec, then the device becomes DSK, the default extension MSG, and
the default ppn [2,2].  (The extension and ppn can be changed later
in the filespec.)  If the next non-blank character is not alphameric,
the filename used is ↓   prg↓, i.e., your programmer name right
adjusted.  (Note that this is your own login name, not the name whose
mail you are editing.)  You can specify a diffrent name with the
formats  ∂prg , ∂prj,prg , ∂prj,* , or ∂prj,  (the latter uses your
own programmer name along with the specified project name).  Any of
these may be followed by .ext and/or [ppn] to change the default
values as described above.

Spooling may only be done to one device (xgp or lpt); once you give a
L or X command, the other one becomes illegal.  Messages so processed
are transferred to a file called QQSPL.TMP in your area, and when you
exit from RCV a SPOOL or XSPOOL command is executed for that file.
This is one of the reasons that you should exit from RCV by typng E,
not <call>!  If you <call> out, files may not get closed.

It is possible, although hopefully unlikely, that a message may be
so long as to overflow RCV's message buffer.  In that case, you will
see as much as fits, followed by an overflow notice and an option
request.  After you enter the desired option, the remainder of the
message will be typed as it is being processed, so you may safely
use the Delete option and you will still see the rest of the message.
If you want to avoid this continued typeout, type the letter "Q"
(for Quiet) before your option choice, e.g., "QD" for Quiet Delete.
"Q" is only recognized when a message overflows.

RCV may be run when not logged in, with an argument specifying the
mail files to be edited; however, the messages may only be examined,
not modified--the message files are simply listed without asking
for processing options.  In this case it is safe to use <call> to
stop reading messages, but please remember that you must kill the job
if you <call> out of it lest it stay around forever!

There are two special options available in RCV, for reading the A.P.
news digest and for editing messages sent with the GRIPE command.
These options are provided when the RCV command is given without an
argument, if you have an OPTION.TXT file with a line of the form
RCV:DIGEST,GRIPE;	(either order, or either one alone, is ok).
The GRIPE option is intended for system wizards, while the DIGEST
option is good for people with both DIGEST and NOMAIL in their
LOGIN options.  You are asked READ DIGEST? or EDIT GRIPES? if the
appropriate files exist.